Skip to content

Sync docs from microsoft/main into microsoft/release-branch.go1.27 - #2711

Merged
bot-for-go[bot] merged 1 commit into
microsoft/release-branch.go1.27from
dev/auto-sync-docs/microsoft/release-branch.go1.27
Nov 11, 2026
Merged

bot-for-go[bot] merged 1 commit into
microsoft/release-branch.go1.27from
dev/auto-sync-docs/microsoft/release-branch.go1.27

Conversation

@bot-for-go

@bot-for-go bot-for-go Bot commented Nov 10, 2026

Copy link
Copy Markdown
Contributor

Hi! I'm a bot, and this is an automatically generated upstream sync PR. 🔃

After submitting the PR, I will attempt to enable auto-merge in the "merge commit" configuration.

For more information, visit sync documentation in microsoft/go-infra.

This PR copies documentation from microsoft/main into microsoft/release-branch.go1.27.

@bot-for-go
bot-for-go Bot requested a review from a team as a code owner November 10, 2026 18:16
Copilot AI balanced review requested due to automatic review settings November 10, 2026 18:16

@review-bot-for-go review-bot-for-go Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Auto-approving.

@bot-for-go bot-for-go Bot added the sync:docs Copies documentation from the main branch label Nov 10, 2026
@bot-for-go
bot-for-go Bot enabled auto-merge November 10, 2026 18:16
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).
There may be pipelines that require an authorized user to comment /azp run to run.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

Unresolved documentation errors omit the setting’s Go 1.27 backport and misrepresent FreeBSD cryptography support across architectures, cgo modes, and Go versions.

3 open issues
What changed in this PR

Synchronizes documentation from microsoft/main into microsoft/release-branch.go1.27, updating user guidance and release download metadata without changing runtime code.

Changes:

  • Adds source-sync notices and consolidates contribution guidance in CONTRIBUTING.md.
  • Refreshes migration, telemetry, platform support, and cryptography documentation.
  • Updates download links to Go 1.27 and 1.26.
File Description
SUPPORT.md Adds source-sync notice only.
SECURITY.md Adds source-sync notice only.
README.md Links to consolidated contribution guidance.
eng/​doc/​Telemetry.md Clarifies version availability of persisted opt-out settings.
eng/​doc/​SupportedPlatforms.md Documents Go 1.28 Windows/386 and OpenSSL 4 support.
eng/​doc/​release-branch-links.json Refreshes release metadata for Go 1.27 and 1.26.
eng/​doc/​README.md Adds source-sync notice only.
eng/​doc/​NocgoOpenSSL.md Clarifies no-cgo backend terminology and selection.
eng/​doc/​MigrationGuide.md Expands version-selection and dependency-pinning guidance.
eng/​doc/​MicrosoftToolsetIdentification.md Adds source-sync notice only.
eng/​doc/​Installation.md Adds source-sync notice only.
eng/​doc/​fips/​UserGuide.md Adds X.509 API and FIPS guidance.
eng/​doc/​fips/​README.md Updates systemcrypto configuration and version guidance.
eng/​doc/​Downloads.md Refreshes download tables for supported releases.
eng/​doc/​DeveloperGuide.md Adds source-sync notice only.
eng/​doc/​CrossPlatformCryptography.md Adds a cgo support matrix and compatibility notes.
eng/​doc/​AdditionalFeatures.md Documents Linux hardening defaults and clarifies ML-KEM configuration.
CONTRIBUTING.md Adds contribution workflow, CLA, and conduct guidance.
CODE_OF_CONDUCT.md Adds source-sync notice only.

Review effort: Balanced

explicit `tls.Config.CurvePreferences`.
It can also be persisted with `go env -w MS_GOTLSMLKEM=0` and cleared with
`go env -u MS_GOTLSMLKEM`.
Microsoft build of Go 1.28 introduces the `MS_GOTLSMLKEM` environment variable, which controls the default use of ML-KEM TLS key exchange in built programs.
| Target platform | Cgo enabled | Cgo disabled |
| --- | --- | --- |
| Linux | ✔️ | ⚠️<sup>1</sup> |
| FreeBSD (since Go 1.27) | ⚠️<sup>2,3</sup> | ⚠️<sup>2</sup> |
Comment on lines +72 to +73
> When using Go 1.26 and targeting Linux or FreeBSD, the table only applies if `GOEXPERIMENT=ms_nocgo_opensslcrypto` is set.
> Otherwise, cgo is always required.
@bot-for-go
bot-for-go Bot merged commit 357f935 into microsoft/release-branch.go1.27 Nov 11, 2026
69 checks passed
@bot-for-go
bot-for-go Bot deleted the dev/auto-sync-docs/microsoft/release-branch.go1.27 branch November 11, 2026 10:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

sync:docs Copies documentation from the main branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants